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1.0 INTRODUCTION 

This document describes the external features and 
characteristics of an implementation of the Digital Research 
Inc. CP/M-80 R2.2 operating system for the Epson QX-10 
microcomputer. This version of the Specification reflects 
the 256K version of CP/M-80 R2.2 designated by Epson as 
release level B2.26. 

The operating system product resulting from this implementa- 
tion includes: 

A system data page. The purpose of the data page is to 
provide specific locations on the system tracks for 
specific supported features. This eliminates the need 
to move code around to compensate for system changes. 
See Appendix G for an illustration of the System Data 
Page . 

A customized Basic Input/Output System (BIOS), inte- 
grated with the unmodified CCP and BDOS components of 
CP/M-80. 

A Reference Manual which supplements the Digital 

Research CP/M-80 documentation and describes to the 

user the unique features and facilities of this imple- 
mentation and how it is used. 

Source code listings of the customized BIOS and 
utilities. 

A detailed specification of the product (this document) 

which when used in conjunction with the source listings 

provides the necessary documentation to support program 
maintenance. 

The requirements used in developing this specification were 
taken from the CP/M-80 Version 2.2 documentation provided by 
Digital Research, the QX-10 technical specifications and 
marketing requirements provided by Epson America, Inc. This 
implementation is designed to support the various QX-10 
system configuration options which include floppy disks, 
printers, video display, keyboard, memory and serial ports. 

The objective of this implementation is to provide 
application program access to the various hardware 
facilities of the QX-10 microcomputer system with a user- 
friendly interface, while providing the functionality of 
CP/M-80 and its large applications software base to the 
Epson QX-10 System customer base. 
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2.0 APPLICABLE DOCUMENTS 

The following documents are relevant to this customization: 

CP/M Operating System Manual by Digital Research 

QX-10 Firmware Specifications - Revision CI (July 10,1982) 

QX-10 System Specification - Revision C5 

QX-10 Technical Manual - Principles of Hardware Operation 

Operator's Manual Models 912/920 by Televideo Systems Inc. 
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3.0 FEATURE DESCRIPTION 



3.1 DEVICE ASSIGNMENTS 



3.1.1 GENERAL DESCRIPTION 

The following tables provide the required correlation for 
the CP/M-80 logical devices, CP/M-80 physical devices and 
the QX-10 physical devices. 



Table 1-1 Device Correspondence 



CP/M-80 QX-10 

Physical Device Physical Device 

CRT: Input = Keyboard 

Output = Video Display 

PTR: Input = Keyboard 

PTP: Output = Video Display 

LPT; Parallel Printer Port 

TTY: Video Display 

UCl: Serial Port 

URl: Serial Port 

UR2: Serial Port 

UPl: Serial Port 

UP2: Serial Port 

ULl: Serial Port 

BAT: Input = Current RDR Setting 

Output = Current LST Setting 



Table 1-2 Permitted Logical to Physical Assignments 



CP/M Logical CP/M Physical 

Device Name Devices 

CON: = TTY: CRT: BAT: UCl; 

RDR: = TTY: PTR: URl: UR2 

PUN: = TTY: PTP: UPl: UP2: 

LST: = TTY: CRT: LPT: ULl: 



NOTE: Table 1-2 is established within CP/M-80 itself and is 
not created or modified by this implementation of CP/M-80 
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3.1.2 USER/OPERATOR INTERFACES 

To display the current assignments in effect, or to make 
changes in the assignments, the User utilizes the various 
options contained in the CP/M-80 STAT command. The command 
STAT DEV: displays the current assignments in effect for the 
four CP/M-80 logical device names: CON:, RDR: , PUN: and 
LST:. The command STAT VAL: displays the possible CP/M 
physical device names that the User can assign to each CP/M 
logical device name as defined in Table 1-2 above. The SETUP 
program stores the current value of the lOBYTE in the system 
data page. This feature allows the User to establish a 
defined configuration which is restored at each cold boot. 



3.1.3 ABORTS AND RECOVERIES 
None. 

3.1.4 ERRORS 
None. 

3.1.5 PERFORMANCE 
Nominal. 

3.1.6 OPERATIONAL CONSIDERATIONS 

The QX-10 physical device assignments shown in Table 1-1 are 
implemented as part of the BIOS customization. The lOBYTE is 
a reserved byte in memory that keeps track of logical-to- 
physical device assignments. Display of the possible lOBYTE 
assignments (Table 1-2) and the current values in effect 
along with modification of the values in effect is 
accomplished through the standard CP/M-80 STAT utility which 
has not been modified for this implementation. 
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3.3 KEYBOARD SUPPORT 



3.3.1 GENERAL DESCRIPTION 

At the option of the User either the production or earlier 

HASCI keyboard is supported as the CP/M-80 R2.2 console 

input device. Keys such as Escape, Caps Lock, Control, 

Graph Shift and all typaraatic keys are supported by the BIOS 
console routines. The BIOS maintains a 128 character type- 
ahead buffer regardless which keyboard is selected. 



3.3.2 USER/OPERATOR INTERFACES 

Keyboard options, such as typamatic keys or which keyboard 
is connected to the system, are handled by the configuration 
utility (SETUP) described in section 3.8. The B Release of 
CP/M-80 supports two keyboards— HASCI -1 and HASCI -2. The 
HASCI-2 keyboard has one function key, EDIT, that is not 
available on the HASCI -1 keyboard. The keypads of the two 
keyboards do not correspond. (See keyboard diagrams in the 
appendix for specific differences, ) 



3.3.3 ABORTS AND RECOVERIES 
None 

3.3.4 ERRORS ^ 
None 

3.3.5 PERFORMANCE 

The BIOS manages the 128 character type-ahead buffer feature 
by running the keyboard in interrupt mode rather than using 
the normal polling technique. 

3.3.6 OPERATIONAL CONSIDERATIONS 

The keyboards supported by this implementation produce scan 
codes which must be mapped into the desired characters. The 
design of the keyboard mapping is table driven and does not 
preclude the support for other keyboard types which may be 
made available during later phases of the QX-10 product 
cycle. 
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The translated scan codes produce the full range of 8-bit 
characters (0-255) enabling generation of graphics charac- 
ters. The Epson product line (QX-10, HX-20 and printer 
products) support a variety of graphics character sets. 
Therefore, flexiblity is provided at system generation time 
to link the particular keyboard tables which translate the 
proper video driver-keyboard-printer combination accurately. 

The character video driver is only able to produce the QX-10 
graphics character set on the console. The ideally suited 
keyboard tables will support the graphics characters in a 
manner similar to the unshifted and shifted graphics 
keyboard mappings as implemented in the Valdocs scheme. 

The graphics video driver has the flexiblity of being able 
to display more than one font on the console. Therefore, 
the driver can support a variety of graphics character sets 
generated by the keyboard or supported by a printer. 
Support of the RX product is acheived on the QX by 
combining the graphics video driver linked with the RX font, 
and the keytables which generate the graphics set supported 
by the RX. 

The hexidecimal keyboard mapping which generates the QX font 
is listed for each keyboard in Appendix A. 

When a keyboard is selected via SETUP, the keyboard in 
effect is displayed as part of the CP/M "sign-on" message at 
either the next power-on or at the next system reset. 
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3.4 PRINTER SUPPORT 

3.4.1 GENERAL DESCRIPTION 

The Epson MX, FX and RX series printers, connected via the 
parallel interface, are supported by the customized BIOS. 
Other printers can be connected if they follow the industry 
standard Centronics compatible parallel interface or the RS- 
232C serial interface and one of the handshaking protocols 
supported by the BIOS serial support options described in 
section 3.7. 

In the case where Epson printers are connected to the QX-10 
via the parallel port, specific support can be identified in 
the SETUP utility. Note: this support is limited to proper 
status byte interpretation. Printer identification through 
SETUP does not affect the video driver - keyboard mapping 
configuration, 

3.4.2 USER/OPERATOR INTERFACES 

Support for the printers is limited to the basic BIOS calls, 
configuration management and error recovery. Support for 
the various printer special features is the responsibilty of 
the application software. 

3.4.3 ABORTS AND RECOVERIES 

Error reporting and error retry options are made available 
to Epson printers connected to the parallel port provided 
that proper printer selection is declared via the SETUP 
utility. If a non-Epson printer is utilized or the printer 
is connected to the serial port, aborts and recoveries are 
the responsibilty of the application software. 

3.4.4 ERRORS 

Errors are reported to the user on line 25. An explanation 
of the error messages is contained in Appendix B, 

3.4.5 PERFORMANCE 

As described in the specific printer model documentation, 
printers connected to the serial port cannot be supported at 
speeds greater than 1200 baud without making changes to the 
jumper options inside the QX-10 itself when hardware 
handshaking is used. Refer to the QX-10 Technical Manual, 
Principles of Hardware Operations, page 4-32, Table 4-8 for 
data relating to the jumpers. 
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3.4.6 OPERATIONAL CONSIDERATIONS 

The assignment of the List Device for CP/M-80 R2.2 is 
accomplished by the logical device assignment option of STAT 
as described in section 3.1. The selection of printer 
options and handshaking methods are handled by SETUP as 
described in section 3.8. 
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3.5 DISK SUBSYSTEMS SUPPORT 

The BIOS provides support for two standard disk subsystems 
on the QX-10: Floppy diskette subsystem and a RAM disk 
subsystem occupying two of the 64K memory banks. Optional- 
ly, the BIOS provides support for a Winchester disk sub- 
system. 



3.5.1 FLOPPY DISK SUBSYSTEM 



3.5.1.1 GENERAL DESCRIPTION 

The BIOS supports the two intergal 5 1/4" double-sided disk 
drives. The standard disk format for this implementation is 
512 Byte sectors with 10 sectors per track. Provision is 
made in the BIOS to read or write (not format) industry 
standard diskette formats from the RIGHT drive. Utility 
programs are available which allow the User to reconfigure 
the RIGHT drive to allow for the importing of application 
software from other systems. 

The BIOS writes all filled or partially filled write buffers 
to disk in the following situations: 

1. Write operation to the directory. 

2. Warm Boot 

This version of the implementation can support other disk 
formats as well as the standard QX-10 format described 
above. The specific data for the QX-10 format and supported 
optional formats is given in Appendix D. 



3.5.1.2 USER/OPERATOR INTERFACES 

In order to read or write files from diskettes recorded in a 
supported optional format, the User must select the the 
format from the SETUP utility. After the utility has been 
run, the BIOS can read or write these diskettes only in the 
RIGHT drive. After reading the desired diskette, and before 
attempting to read standard QX-10 formatted diskettes, the 
User must reselect the QX-10 format with the SETUP utility. 
The QX-10 format is always in effect after a power-on or a 
system reset. Once the RIGHT drive has been alterred by the 
SETUP utility it remains in effect through a warm start 
(CONTROL C). 
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3.5.1.3 ABORTS AND RECOVERIES 

Error reporting and error retry options are available to the 
User and are selectable from the SETUP utility. These 
options are as follows: 

1. Diagnostic Error Messages 

2. Standard Disk Error Retry 

The error indications made available to the User during disk 
error recovery are a function of the status of the Disk 
Subsystem Options in effect at the time of the anomaly. 
There are four possible option conditions and the 
indications for them are summarized below: 

1. If "Diagnostic Error Messages" and "Standard Disk Error 
Retry" are both enabled then the disk error recovery is 
attempted five (5) times and if the operation fails all five 
times, the User is queried on line 25 to select the 
appropriate response from the following list of 
possibilities: 

( R ) etry/ ( A ) bort/ ( C ) ont inue/ ( I ) gnore 

2. If "Diagnostic Error Messages" is disabled and "Standard 
Disk Error Retry" is enabled the disk error recovery is 
attempted five (5) times and if the operation fails all five 
times the error is reported to BDOS without the line 25 
query for appropriate action. 

3. If "Diagnostic Error Messages" is enabled and "Standard 
Disk Error Retry" is disabled the disk recovery is attempted 
one (1) time and if unsuccessful the User is queried on line 
25 for the appropriate action. 

4. If "Diagnostic Error Messages" and "Standard Disk Error 
Retry" are both disabled the disk recovery is attempted one 
(1) time and if unsuccessful the error is reported to BDOS 
without the line 25 query, 

3.5.1.4 ERRORS 

Recoverable errors are reported to the user on line 25 
according to the reporting options selected by the user 
during configuration option selection. Fatal errors are 
always reported both to the user and to BDOS. An 
explaination of the error messages is given in Appendix. 

3.5.1.5 PERFORMANCE 
Nominal. 
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3.5.1.6 OPERATIONAL CONSIDERATIONS 

The system supports one standard QX-10 format and a number 
of additional formats on the RIGHT drive through the use of 
the SETUP utility which sets the disk format, density and 
double sided attributes. The two floppy disk drives are 
referred to as LEFT and RIGHT respectively by the SETUP and 
COPYDISK utilities. 

On a system without hard disk support, the BIOS addresses 
the two diskette drives as "A" and "B". When hard disk 
support is available, disk designations can be altered at 
system generation time as well as cold boot time. 
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3.5.2 RAM DISK SUBSYSTEM 

3.5.2.1 GENERAL DESCRIPTION 

The customized BIOS supports one RAM disk occupying banks 2 
and 3 of the QX-10 memory banks. The standard disk format 
for this implementation is 128 byte sectors with 128 sectors 
per track. 

The system provides a locking mechanism to protect data in 
the RAM disk from being overlaid by data transferred via 
XBIOS Calls, to banks 2 and 3. 

3.5.2.2 USER/OPERATOR INTERFACES 

The RAM disk is configured as drive "M". This designation 
can be altered at system configuration time as well as by 
the drive assignment option of the SETUP utility. RAM disk 
support can be ENABLED or DISABLED through the SETUP 
utility. 

There are three extended BIOS calls, XBIOS 48 - Move Block 
to another Bank, XBIOS 49 - Call Code in another Bank, and 
XBIOS 50 - Jump to Code in another Bank, that permit the 
user to move data and/or code to banks 2 and 3, and excute 
there. To execute one of these calls, the user must first 
execute XBIOS 46, Request Memory Bank, which insures that a 
contention for Banks 2 and 3 does not exist between the 
XBIOS calls and RAM disk usage. 

Upon execution of XBIOS 46, the system checks the status of 
the RAM disk: 

o If the RAM disk status is DISABLED, the requested bank is 
allocated to the requesting code with a success condition 
returned. 

o If the RAM disk status is ENABLED, an error code is 
returned to the requesting code. 

3.5.2.3 ERROR CONDITIONS 

Two error conditions can occur: 

- 1, RAM disk is ENABLED when XBIOS 46 is executed. 

- 2, RAM disk is ENABLED and contains data, and user attempts 
to DISABLE RAM disk through SETUP. 

If either condition occurs, the folloring message displays: 

RAM disk data may be lost: (A)bort or (C)ontinue. 



15 



** 12/10/84 ** CP/M-80 R2.2 ERS - Release B2.26 Page 3-11 



3.5.2.4 ABORTS AND RECOVERIES 

If error condition 1; 

-(A)bort warm boots with RAM disk still enabled. 

-(C)ontinue disables RAM disk, allocates the requested bank. 

If error condition 2; 

-(A)bort leaves RAM disk ENABLED and warm boots. 

-(C)ontinue DISABLES the RAM disk. 

3.5.2.5 PERFORMANCE 

Given the nature of a RAM disk, high speed data throughout 
is generally, achieved. 

3.5.2.6 OPERATIONAL CONSIDERATIONS 

Because the RAM disk occupies a maximum of two storage 
banks, the capacity of drive "M" is limited. 

The storage media is volatile. Files can be corrupted at 
system reset and will be lost at power off. Additional 
overhead can accrue at cold boot if the given implementation 
requires loading the RAM disk with files. 
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3.5.3 WINCHESTER DISK SUBSYSTEM 

3.5.3.1 GENERAL DESCRIPTION 

The BIOS supports one formatted, ten-megabyte, Comrex hard 
disk. When installed in the QX-10, the hard disk is divided 
into two five-megabyte logical drives, HI and H2. Each 
logical drive has 512-byte sectors and 16 sectors per track. 

3.5.3.2 USER/OPERATOR INTERFACES 

The Comrex hard disk is accompanied by software and 
documentation that: 

1. Specifies hardware installation. 

2. Describes testing and maintenance procedures. 

After physically attaching the hardware to the QX-10, the 
user logically installs the hard disk. By selecting the 
Drive Assignment Option of the SETUP utility the user can 
assign the two logical drives (HI and H2) of the hard disk 
to any of the CP/M logical drives (A-P). 

Note: The system default drives are A:=F1 and B:=F2, where 
F = floppy disk. 

3.5.3.3 ABORTS AND RECOVERIES 

Error reporting and error retry options are available to the 
user and are selectable from the SETUP utility. These 
options are as follows: 

1. Diagnostic Error Messages 

2. Standard Disk Error Retry 

The error indications made available to the User during disk 
error recovery are a function of the status of the Disk 
Subsystem Options in effect at the time of the anomaly. 
There are four possible option conditions and the 
indications for them are summarized below: 

1. If "Diagnostic Error Messages" and "Standard Disk Error 
Retry" are both enabled then the disk error recovery is 
attempted five (5) times and if the operation fails all five 
times, the User is queried on line 25 to select the 
appropriate response from the following list of 
possibilities: 

(R ) etry/ ( A ) bort/ ( C ) ont inue/ { I ) gnore 
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2, If "Diagnostic Error Messages" is disabled and "Standard 
Disk Error Retry" is enabled the disk error recovery is 
attempted five (5) times and if the operation fails all five 
times the error is reported to BDOS without the line 25 
query for appropriate action. 

3, If "Diagnostic Error Messages" is enabled and "Standard 
Disk Error Retry" is disabled the disk recovery is attempted 
one (1) time and if unsuccessful the User is queried on line 
25 for the appropriate action. 



4. If "Diagnostic Error Messages" and "Standard Disk Error 
Retry" are both disabled the disk recovery is attempted one 
(1) time and if unsuccessful the error is reported to BDOS 
without the line 25 query. 



3.5.3.4 ERRORS 

Recoverable errors are reported to the user on line 25 
according to the reporting options selected by the user 
during configuration option selection. Fatal errors are 
always reported both to the user and to BDOS. An 
explanation of the error messages is given in Appendix B. 



3.5.3.5 PERFORMANCE 

The Comrex hard disk spins at 3600 rpm and transmits data at 
5 million bits per second — approximately 10 times as fast as 
a floppy disk. The storage capacity of the Comrex hard disk 
is 10 to 15 times greater than that of a floppy disk. 



3.5.3.6 OPERATIONAL CONSIDERATIONS 

Sudden shocks and vibrations can damage the hard disk. 
Handle with care, particularly when moving it from place to 
place. 
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3.6.3 HARD DISK PARTITIONING 



3.6.3.1 GENERAL DESCRIPTION 



this section to be added 
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3.6 OPERATING SYSTEM CONFIGURATION 
3.6.1 COLD BOOT LOADER 



3.6.1.1 GENERAL DESCRIPTION 

The CP/M-80 R2.2 operating system is loaded into memory in 
two steps. The QX-10 I PL ROM loads in the Cold Boot Loader 
into memory. The Cold Boot Loader loads the CP/M Loader 
which in turn loads CP/M-80. 

The I PL ROM brings in the first 4K of data from track of 
the diskette in the LEFT drive. Included in this 4K is the 
Boot Loader program. The Boot Loader program relocates 
itself down to location lOOH (decimal 256) from the location 
FOOOH. The loader program then loads the CP/M Loader 
program into memory. 

The CP/M Loader program is comprised of a condensed loader 
BDOS and a skeletal BIOS which provides disk I/O capablities 
to the loader. The loader searches the directory for file 
CPM2.SYS which is read into memory. The file contains load 
addresses and the entire CP/M structure. The loader 'loads' 
CP/M and jumps to the cold boot vector. 

System configuration information, as defined by the CP/M-80 
configuration utility SETUP, is also contained in the system 
track area. This information is not processed by the loaders, 



3.6.1,2 USER/OPERATOR INTERFACES 

When the system initiates the boot sequence the "INSERT 
DISKETTE" message is erased from the screen. The next 
message to be displayed is the sign-on message which is 
centered horizontally and displayed near the top of the 
screen. The exact format of the sign-on message is given 
below: 
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CP/M-80 R2.2 FOR THE EPSON QX-10 
COPYRIGHT (C) 1983, EPSON AMERICA, INC, 
ALL RIGHTS RESERVED 
256K - VERSION B2.26 



NOTE: The CP/M-80 A> prompt is shown for reasons of 
completeness and is not part of the sign-on message itself. 



3.6.1.3 ABORTS AND RECOVERIES 

Standard disk error recovery is utilized as defined in 
Appendix B.l. 



3.6.1.4 ERRORS 

If drive A is not ready, the boot ROM displays the message 
"INSERT DISKETTE". If a non-system diskette is inserted into 
drive A, the ROM will unsuccessfully attempt to read the 
boot loader and continuously repeats the "INSERT DISKETTE" 
message. 



3.6.1.5 PERFORMANCE 

Initial program load time takes approximately 17 seconds, 

3.6.1.6 OPERATIONAL CONSIDERATIONS 

The sign-on message and the CP/M-80 A> prompt are displayed 
in normal intensity. At the completion of the Boot Loader 
procedure the system is left in the normal intensity mode. 
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3.6.2 GENCPM - SYSTEM GENERATION 

3.6.2.1 GENERAL DESCRIPTION 

GENCPM2.COM is the system generation module for the B 
Release of the Epson CP/M-80. Its purpose is to modify the 
existing CPM2.SYS file, which contains the system BIOS, 
BDOS, and the CCP. 

To perform system generation, GENCPM2 requires the presence 
of two files: 

o The CPM2.SYS file for the existing system 

o EBIOS.SPR, the System Page Relocatable file, which is 
created via selection of the B switch of the linker 
and contains the non-relocated BIOS Code. 



3.6.2.2 USER/OPERATOR INTERFACES 

OEM (User) decides which portion of the BIOS to assign to 
common RAM (CSEG) and which portion to assign to banked RAM 
(DSEG) , and makes the appropriate assignments in source code 
using the CSEG and DSEG assembler directives. 

OEM (User) makes system modifications with an editor, 
assembles the modified files with either RMAC (DRI) or M80 
(Microsoft), links the modules with LINK80 (DRI) using the 
linker B switch to create EBIOS.SPR, and finally runs 
GENCPM2.COM. GENCPM2.COM relocates the DSEG and CSEG Code 
segments and appends the relocated BIOS onto the CMP2,SYS file. 

If there are no errors, the Memory Map (displaying the 
locations of CSEG and DSEG) will be displayed. If there are 
errors, error messages will be displayed. 



3.6.2.3 ABORTS AND RECOVERIES 

GENCPM2 aborts on any error condition. There are no 
recovery techniques. 



This Information is Proprietary to Epson America, Inc. 



** 12/10/84 ** CP/M-80 R2.2 ERS - Release B2.26 Page 3-18 

3.6.2.4 ERRORS 

GENCPM2 checks for the presence of the CPM2.SYS and 
EBIOS.SPR files. If either of these files is not present, 
the appropriate message is displayed: 

ERROR! EBIOS.SPR FILE NOT FOUND 

ERROR! CPM2.SYS FILE NOT FOUND 



If both CPM2.SYS and EBIOS.SPR are present, GENCPM2 takes 
the header information from EBIOS.SPR and checks the size of 
CSEG and DSEG. 

If CSEG as coded in the EBIOS.SPR file exceeds the 
boundaries allotted to it, the following message is displayed: 

ERROR! CSEG TOO LARGE 

If DSEG as coded in the EBIOS.SPR file exceeds the 
boundaries allotted to it, the message is displayed: 

ERROR! DSEG TOO LARGE 

Other possible error messages are CLOSE ERROR, which 
indicates that the CPM2.SYS file could not be closed, and 
READ/WRITE errors in accessing EBIOS.SPR or CPM2.SYS. 



3.6.2.5 PERFORMANCE 

The error-checking capabilities of GENCPM2 protect the user 
from unintentionally overlaying code. 

3.6.2.6 OPERATIONAL CONSIDERATIONS 

GENCPM2.COM updates the CPM2.SYS file present on the 
currently selected drive. The CPM2,SYS file would need to be 
copied to the bootable system diskette. 

To make additional copies of the operating system, the user 
runs the "Copy System Only" option of the Epson 
COPYDISK utility, which copies both the system tracks 
and the CPM2.SYS file to the destination diskette. 
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3.6.3 OEM CONFIGURATION SUPPORT 

3.6.3.1 GENERAL DESCRIPTION 

OEM support is a major feature of the "B" release. The BIOS 
code is divided into logic modules (patterned after CP/M 3.0 
structure) which are linked together to form the CP/M 
environment. OEM supplied modules which adhere to a defined 
structure can be included in the link process and become an 
integral part of the CP/M environment provided to the end 
user. 

3.6.3.2 USER/OPERATOR INTERFACES 

A dummy module named OEMINIT is provided for the use of the 
OEM to customize the system. This routine has two entry 
points: ?OEMIC and ?OEMIW. The entry point ?OEMIC is called 
by the cold boot logic, while ?OEMIW is called by the warm 
boot logic. 

The OEM may add whatever logic is required to customize the 
operating system to his specific requirements. For example 
the OEM can add an interrupt routine to the system to handle 
a new device such as a hard disk drive. Another routine can 
be added which initializes another device at warm boot. 

Below are outlined the guidelines which an OEM must follow 
to integrate customized routines to the QX-10 CP/M BIOS: 

- All interrupt routines must be initialized in the ?OEMIC 
routine. The start of the interrupt vector table can be 
determined by references to the system variable @IPBASE. 
The ?OEMIC logic must set the interrupt routine address in 
the appropriate vector location in the table. 

- Interrupts must not be enabled in either the ?OEMIC or 
?OEMIW routines. 

- The interrupt routine initialization logic must set the 
mask value for the appropriate 8259. The OEM must know 
which 8259 is responsible for handling the interrupts for 
the device for which the routine is being provided. The 
interrupt mask for the first 8259 can be found at @8259A and 
the second at @8259B. The initialization logic must access 
the value at that location and "OR" in the necessary mask 
bit for that device. Upon return from ?OEMIC the system 
will set the interrupt masks for each 8259. 

- The interrupt routine must be in the same context (address 
space) as the system interrupt vector. No provision has 
been made for the system to perform a bank switch to 
transfer control to an interrupt routine. 
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- An OEM interrupt routine is responsible for sending the 
EOI command to the appropriate 8259 after the interrupt has 
been serviced. The routine must exit with the RETI 
instruction. 

-If at anytime the OEM's logic wishes to change the mask 
bit for a device controlled by the OEM'S routines, the 
appropriate mask byte may be accessed and changed by the 
procedure outlined above. The EOI routine may then call 
?825CA or ?825CB the have the mask value changed. 



3.6.3.3 ABORTS AND RECOVERIES 
The responsibility of the OEM. 

3.6.3.4 ERRORS 

The responsibility of the OEM. 

3.6.3.5 PERFORMANCE 
Not applicable. 

3.6.3.6 OPERATION CONSIDERATIONS 

- The initialization logic in ?OEMIC cannot program the 8259 
controllers. The OEM must use the system values for the 
8259 initialized by the BIOS. 



- An OEM supplied interrupt routine is responsible for 
saving and restoring CPU status and all registers which are 
used by the routine. 
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3.7 SERIAL INTERFACE SUPPORT 

3.7.1 GENERAL DESCRIPTION 

The RS-232 serial port, of the QX-10 system is supported by 
the customized BIOS. The serial port is supported as 
character stream input/output devices and can be connected, 
by the User, to CP/M-80 R2.2 logical devices with the STAT 
utility. The System Configuration Utility is used to set 
the port characteristics and protocol to be supported by the 
BIOS routines. The ETX/ACK or XON/XOFF software handshaking 
protocols as well as the RTS/CTS hardware handshaking are 
supported by the BIOS routines. 

Text to be added discussing interrupt/polled drivers. 



3.7,2 USER/OPERATOR INTERFACES 

The user interfaces with the serial port support through 
SETUP utility described in section 3.8, Port characteristics 
are defined through SETUP. 



3.7.3 ABORTS AND RECOVERIES 
None. 

3.7.4 ERRORS 

Text to be added discussing interrupt/polled drivers, 

3.7.5 PERFORMANCE 

Text to be added discussing interrupt/polled drivers, 

3.7.6 OPERATIONAL CONSIDERATIONS 

Text to be added discussing interrupt/polled drivers, 
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4.0 SYSTEM LEVEL DESCRIPTION 

4.1 PUBLICATIONS 

User Manual 

Informs the User of CP/M-80 R2.2 on the Epson QX-10 System 
of the specific characteristics of this customization of 
CP/M-80 R2.2 of which they should be aware. This would 
include the use of the keyboard and a description of the 
video display programming interface as well as unique 
utility programs. 

Programmer's Manual 

The External Reference Specification plus the Digital 
Research CP/M-80 documentation provides the technical 
information for the applications programmer who must 
customize some application program (such as full screen word 
processor) to the Epson QX-10 System. 

Maintenance Manual 

This document contains the technical specifications and 
program logic of the Customized BIOS and utilities for CP/M- 
80 R2.2 on the Epson QX-10 system. This manual would be used 
by those who are responsible for maintaining this 
customization of CP/M-80 R2.2. This ERS and the program 
source listings provide this information. 

4.2 EQUIPMENT CONFIGURATION 

HASCI keyboard, 2 diskette drives, Monochrome display, 256K 
RAM, 1 parallel port, and one RS232C serial port. 

4.3 INTERFACES WITH OTHER SOFTWARE 

Although not specifically addressed in this customization, 
the ground work is laid in place to not preclude the 
interface with the CP/M Plus, MP/M-80 and CP/NET-80 software 
products. Support for Synchronous communication capability 
using the serial ports is not addressed in this implementa- 
tion. Additional marketing requirements are needed in order 
to externally specify this feature. 

4.4 RELIABILITY, AVAILABILITY, SERVICEABILITY 

All errors will be reported to the user. Recovery will be 
attempted if possible. Any unknown errors will cause a warm 
boot of CP/M-80 R2.2. 
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The memory map for this implementation of CP/M-80 is defined 
as follows; 



FFFFH 

FOOOH 

E200H 
EOOOH 



OlOOH 
OOOOH 



RESIDENT 
BIOS 



BDOS 



///////// 



BANKED 
BIOS 



CCP - 



TPA 



PAGE 



SAVED 
CCP 
BANKED 
BIOS 



RAM DISK M 

OR 

EXTENDED TPA 
ADDRESS SPACE 



BANK BANK 1 BANK 2 BANK 3 



Table 1-5 Memory Map 



\ 



\ COMMON 
/ RAM 



/ 



COOOH 



BANKED RAM 



MODULE 

BIOS 
BDOS 
CCP 



BASE ADDRESS 

FOOOH 
E200H 
DAOOH 



Table 1-6 Operating System Base Addresses 
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The memory map in Table 1-5 indicates full utilization of 
256K RAM. Bank is reserved as the system bank. The BIOS 
is divided into two distinct sections. The resident section 
resides in common RAM and is responsible for intercepting 
BIOS calls, swapping in the system bank, and vectoring to 
the appropriate code in the banked BIOS. By segmenting the 
BIOS as shown, code overhead is reduced to a minimum 
enabling the TPA to increase to an acceptable size. The TPA 
extends into common RAM. The shaded area indicates the 
portion of common RAM overlayed by the TPA. If the 
application program residing in the TPA does not make any 
BDOS calls, the TPA can also overlay BDOS. Table 1-6 shows 
the base addressess of the BIOS, BDOS and CCP, 

The RAM disk is mapped onto banks 2 and 3. The RAM disk is 
activated/deactivated through a SETUP selection. When the 
RAM disk is disabled, an intelligent program using XBIOS 
calls 48, 49 and 50 can use banks 2 and 3 as additional data 
and code sections. 
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APPENDIX B. XBIOS Interface 

Table 1-7 below describes the entry points into the BIOS. 
The first 16 entry points correspond to the standard CP/M-80 
implementation. Entries 16-29 are null entries which vector 
to a RET instruction producing a return to the invoking 
code. The last entry point, QXFUNC, is an Epson unique 
entry point through which the extended BIOS services are 
provided. QXFUNC is the 30th vector which in CP/M Plus is 
reserved for System Implementor. This provides a common 
entry point in both CP/M-80 and CP/M Plus. 



No. 


Entry Name 


Function 





BOOT 


Cold Boot Entry 


1 


WBOOT 


Warm Boot Entry 


2 


CONST 


Console Input Status 


3 


CONIN 


Console Input 


4 


CONOUT 


Console Output 


5 


LIST 


List Output 


6 


PUNCH 


Punch Output 


7 


READER 


Reader Input 


8 


HOME 


Home Selected Disk 


9 


SELDSK 


Select Disk 


10 


SETTRK 


Set Track Number 


11 


SETSEC 


Set Sector Number 


12 


SETDMA 


Set DMA Address 


13 


READ 


Read Sector 


14 


WRITE 


Write Sector 


15 


LISTST 


List Device Status 



Vector to Return Instruction 
30 QXFUNC QX-10 XBIOS Functions 
Table 1-7 BIOS Entry Points 



The QX-10 
pages. 



XBIOS Functions are described on the following 
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The CP/M convention for accessing BDOS functions is adopted 
for accessing the XBIOS Functions. The XBIOS Functions are 
accessed by making a direct call to QXFUNC. The function 
number is passed in register C with the information address 
in the double byte pair DE. The XBIOS calls adhere to 
normal CP/M conventions concerning BIOS responsibilities in 
register maintenance. 

- The XBIOS routines do not maintain registers. The 
results of registers upon return is is guaranteed only 
for registers returning result codes or specified data. 

- The XBIOS routines use the alternate register set. 
An application using the alternater register set must 
save registers prior to making an XBIOS call. 

- The XBIOS routines use the IX and lY registers. The 
application program must preserve the IX and lY 
registers prior to making an XBIOS call. 



XBIOS 00 
XBIOS 01 
XBIOS 02 
XBIOS 03 
XBIOS 04 
XBIOS 05 
XBIOS 06 
XBIOS 07 
XBIOS 08 
XBIOS 09 
XBIOS 10 
XBIOS 11 
XBIOS 12 
XBIOS 13 
XBIOS 14 
XBIOS 15 
XBIOS 16 
XBIOS 17 
XBIOS 18 
XBIOS 19 
XBIOS 20 
XBIOS 21 
XBIOS 22 
XBIOS 23 
XBIOS 24 
XBIOS 25 
XBIOS 26 
XBIOS 27 
XBIOS 28 



Floppy Disk Drive Function 

Flush Active Floppy Disk Buffer 

Disk Error Reporting 

Get DRVTBL Address 

Set Foreign Disk Format 

Get System Data Page 

Update System Data Page 

Put System Data Page 

Get Time 

Put Time 

Return BIOS Version Number 

Display User Message on Status Line 

Reserved 

Load Font 

Select Font 

Read Custom Font 

Write Custom Font 

Save Current Font Number 

Restore Current Font Number 

Read International Font 

Get Scan Code Table 

Put Scan Code Table 

Save Scan Code Table 

Restore Scan Code Table 

Get Scan Character 

Put Scan Character 

Read Scan Code Table 

Write Scan Code Table 

Set BIOS To Return Scan Code or 

Converted Character 
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XBIOS 


29 


XBIOS 


30 


XBIOS 


31 


XBIOS 


32 


XBIOS 


33 


XBIOS 


34 


XBIOS 


35 


XBIOS 


36 


XBIOS 


37 


XBIOS 


38 


XBIOS 


39 


XBIOS 


40 


XBIOS 


41 


XBIOS 


42 


XBIOS 


43 


XBIOS 


44 


XBIOS 


45 


XBIOS 


46 


XBIOS 


47 


XBIOS 


48 


XBIOS 


49 


XBIOS 


50 


XBIOS 


51 


XBIOS 


52 


XBIOS 


53 


XBIOS 


54 


XBIOS 


55 


XBIOS 


56 


XBIOS 


57 


XBIOS 


58 


XBIOS 


59 


XBIOS 


60 


XBIOS 


61 


XBIOS 


62 


XBIOS 


63 


XBIOS 


64 


XBIOS 


65 


XBIOS 


66 


XBIOS 


67 


XBIOS 


68 


XBIOS 


69 


XBIOS 


70 


XBIOS 


71 


XBIOS 


72 


XBIOS 


73 


XBIOS 


74 


XBIOS 


75-90 


XBIOS 


91 


XBIOS 


92 


XBIOS 


93-127 



Set Function Key Enable/Disable Mode 

Select Function Key Table 

Save Current Function Key Table Pointer 

Restore Function Key Table Pointer 

Get Selected Function Key Table 

Put Selected Function Key Table 

Save Selected Function Key Table 

Restore Selected Function Key Table 

Get Function Key 

Put Function Key 

Disable System Key 

Enable System Key 

Read Custom Function Key Table 

Write Custom Function Key Table 

Enable Keyboard Reset at Warm Boot 

Perform Warm Boot Reset 

Disable Keyboard Reset - XBIOS 43 

Request Memory Bank 

Release Memory Bank 

Move Block to another Bank 

Call Code in another Bank 

Jump to Code in another Bank 

Display RAM Disk Overwrite Message 

Reserved 

Reserved 

PSET - Pixel Set/Reset 

Set Viewport 

Graphics Drawing Primatives 

Direct Cursor Addressing 

Direct String Display Function 

Reserved 

Set User Interrupt Vector 

Clear User Interrupt Vector 

Get Interrupt Mask 

Enable Interrupt 

Disable Interrupt 

Not Available 

Not Available 

Not Available 

Not Assigned 

Not Assigned 

Clear mode attributes in Character Driver 

Clear mode attributes in Bitmap Driver 

Set Cursor Shape 

Load CCP into TPA memory 

Move boot string into CCP 

Not Assigned 

Attach Internal Communications Driver 

Detach Internal Communications Driver 

Not Assigned 
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XBIQS 00 Floppy Disk Drive Function 

Entry: A = Error Reporting Control 

- BIOS reports error 

1 - Error Returned to Galling Code 

C = 00 

DE = Parameter Buffer Address 

Buffer Contents: byte - Unit number 0,1 

0: Left Drive 
1: Right Drive 

byte 1 - Function code 
0: Home 

1: Read data track 
2: Write data track 
3: Read system track 
4: Write system track 

byte 2 - Sector 

0-31: system track 
0-19: data track 

byte 3 - Track 
0-39 

byte 4,5 - DMA Address (Intel format) 
DMA buffer size 
256 bytes: system track 
512 bytes: data track 

Return: A = - operation successful 

A <> - operation unsuccessful 

3 - read/write error 

4 - seek error 

5 - disk not ready error 



XBIQS 01 Flush Active Floppy Disk Buffer 

Description: 

This XBIOS call will write a 'dirty' disk buffer 
onto the affected diskette. 

Entry: C = 01 

Return: A = - operation successful 

A <> - operation unsuccessful 
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XBIOS 02 



Disk Error Reporting 



Description; 

This XBIOS call displays disk error message on the 
25th line and waits for user response. Although 
it prompts user to enter (R) for retry, (A) for 
abort, (C) for continue and (I) for ignore, the 
program does not limit the entry to these 4 char- 
acters. If "A" is entered, the system will select 
drive A then do a warmboot. All other character 
will be converted to upper case (ANI ODFH) and 
returned in register A. It is the responsibility 
of the application program to take care of retry, 
continue, ignore or other operations after 
receiving the character from user. 

Entry: C = 02 

A = Error Code 

3 - read/write error 

4 - seek error 

5 - drive not ready 

B = Error Drive Designator (0-15) 

Return: A = Action Code 
"R" - Retry 
"C" - Continue 
"I" - Ignore 

Other characters entered by user 
A = -1 indicates error in input parameters 



XBIOS 03 



Get DRVTBL Address 



Description: 

Drvtbl defines the physical to logical disk drive 
assignment. Sixteen entries are available for 
logical drive A to P. For existing physical 
drive, the address of its disk parameter table is 
put in the proper entry corresponding to the 
logical drive letter. Entries for non-existing 
drives are set to zero. 

Entry: C = 03 

Return: DE = Address of DRVTBL in common RAM 
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XBIOS 04 



Set Foreign Disk Format 



Entry: C = 04 

DE = Pointer to DPB and NEC 765 parameter table. 

Following are tables for QX-10 380K format. 



@DT5B: DW 


80 


SECTORS PER TRACK 


DB 


4 


BSH 


DB 


15 


,BLM 


DB 


1 


EXM 


DW 


190-1 


BLOCKS- 1 


DW 


128-1 


TOTAL DIR ENTRIES 


DW 


192 


DIR BLOCK ALLOCATION 


DW 


32 


CHECKED DIR ENTRIES 


DW 


2 


DIRECTORY TRACK 


@PTBLB: 






DB 


16 


BLKSIZE/128 


DB 


80 


HSTBLK * HSTSPT 


DB 


2 


SECTOR SHIFT FACTOR 


DB 


3 


SECTOR MASK 


DB 


10 


# SECTORS/TRK 


DB 


15 


DISK GAP FACTOR 


DB 


2 


NEC 765 SECTOR FACTOR 


DW 


512-1 


DMA BYTE CNT FACTOR 


DB 


4 


SECTOR TRANSLATE FACTOR 


DB 





LONG DISK FLAG 


DB 


40 


DISKETTE TRACK COUNT 



This Information is Proprietary to Epson America, Inc. 



** 12/10/84 ** CP/M-80 R2.2 ERS - Release B2.26 



Page B-7 



XBIOS 05 



Get System Data Page 



Description: 

Get a copy of current system data page in memory 
into a 128 byte buffer pointer by register DE. 

Entry: C = 05 

DE = Address of 128 byte buffer 

Return: Contents of SDP moved to buffer 



XBIOS 06 



Update System Data Page 



Description: 

Put the content of the 128 byte buffer pointed by 
register DE into current system data page in memory. 

Entry: C = 06 

DE = Address of 128 byte buffer 

Return: Contents of buffer moved to SDP 



XBIOS 07 



Put System Data Page 



Description: 

Copy the content of current system data page in memory 
into diskette. The bootable diskette must be in the 
left drive. System data page is located at physical 
track 0, sector 2 of the diskette. The description of 
each byte in the system data page can be found at 
appendix D, 



Entry: 
Return: 



C = 07 

A = 
A <> 



operation successful 
operation unsuccessful 
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XBIOS 08 Get Time 

Entry: C = 08 

DE = Address of a 7 byte buffer 

Buffer contents: byte - day of week (1-7) 

byte 1 - month (1-12) 

byte 2 - day (1-31) 

byte 3 - year (0-99) 

byte 4 - hour (0-23) 

byte 5 - minute (0-59) 

byte 6 - second (0-59) 

Return: Date and Time information moved to buffer 

XBIOS 09 Put Time 

Entry: C = 09 

DE = Address of a 7 byte buffer 

Buffer contents: same as XBIOS 08 

Return: Date and Time information moved from buffer 
and clock chip initialized. 

XBIOS 10 Return BIOS Version Number 

Entry: C = OAH 

Return: BIOS version number returned as ascii characters 
in registers DE and HL. Current version: 

DE = B2 
HL = 25 

XBIOS 11 Display User Message on Status Line 

Entry: C = OBH 

HL = Address of ascii string terminated with null 
byte. 

Return: A = User keyboard response to status message. 
Depending on XBIOS 28, reg A contains keyboard 
scancode or converted character, 

XBIOS 12 RESERVED 

Entry: C = OCH 

Description: Reserved for future expansion. No operation. 
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XBIOS 13 



Load Font 



Description: 

This XBIOS call is used to load a user defined 
font into STYLE font area. Each individual 
character requires 16 bytes of data. The 
following example shows how to build a character 
out of the 16 byte bit image. 

The 16 byte data for standard font "B" is 

41h,41h,21h,lfh,0,0,0,0,lfh,21h,41h,41h,21h,lfh,21h,41h 



byte 


data 


8 


If 


9 


21 


10 


41 


11 


41 


12 


21 


13 


If 


14 


21 


15 


41 





41 


1 


41 


2 


21 


3 


If 


4 





5 





6 





7 






bit 12 3 4 5 6 7 

X X X X X 
X X 

X X 

X X 

X X 

X X X X X 
X X 

X X 

X X 

X X 

X X 

X X X X X 



Entry: 



The buffer size for the STYLE font is OCOOH. The 
first 0600H is designated to the STYLE font and 
the remaining 0600H to the STYLE BOLD font. The 
fonts are numbered from OOH to 5FH which 
corresponds to ASCII code 20H to 7FH. Refer to 
appendix J for fonts tables. 

C = ODH 

DE = Address of buffer area containing font 



Return: Font moved to STYLE font area 
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XBIOS 14 Select Font 

Entry; C = OEH 

A = Font # to be selected 
; standard 
1: standard bold 
2: italic 
3: italic bold 
4: style 
5: style bold 
others: return with no font changed 

Return: Font pointer updated to point to selected font 

XBIOS 15 Read Custom Font 

Description: Read STYLE fonts from system track into memory. 

Entry: C = OFH 

Return: A = - operation successful 

A <> - operation unsuccessful 

XBIOS 16 Write Custom Font 

Description: Write STYLE fonts from memory to system track. 

Entry: C = lOH 

Return: A = - operation successful 

A <> - operation unsuccessful 

XBIOS 17 Save Current Font Number 

Entry: C = IIH 

Return: The current font pointer is saved. 

XBIOS 18 Restore Font Number 

Entry: C = 12H 

Return: The font pointer is restored. 

XBIOS 19 RESERVED 

Entry: C = 13H 

Description: Reserved for future expansion. No operation. 
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XBIOS calls 20-28 deal with the keyboard scan code table. 
The size of the scan code table is 0300H bytes. The tables 
contain the maps to translate keyboard scan codes to 8-bit 
data bytes which are input into the BIOS console input 
buffer. System keys and Function keys are handled in other 
tables. The structure of the 0300H table is shown as follows: 



OOh 



BOh 



lOOh 



IBOh 



200h 



280h 



300h 



no shift keys 



shift 



control 



control shift 



graph shift 



graph shift shift 



Refer to Appendix F for scan code tables. 
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XBIOS 20 Get Scan Code Table 

Entry: C = 14H 

DE = Address of IK buffer 

Return: Keyboard Scan Code Table moved to buffer 



XBIOS 21 Put Scan Code Table 

Entry: C = 15H 

DE = Address of IK buffer containing user-defined 
scan code table. 

Return: User scan codes moved over system scan code table 



XBIOS 22 Save Scan Code Table 

Entry: C = 16H 

Return: Contents of System Scan Code Table copied to save area 

XBIOS 23 Restore Scan Code Table 

Entry: C = 17H 

Return: Contents of scan code save area copied over System Scan 
Code (only if a XBIOS 22 function previously performed) 

XBIOS 24 Get Scan Character 

Entry: C = 18H 

D = Shift Mask 

OOOB : no shift keys 

OOIB : shift 

OlOB : control 

OllB : control shift 

lOOB : graph shift 

lOlB : graph shift shift 
E = Scan Code 

- 7FH 

Return: A = Assigned Code 

Example: If D = , E = 43h 
Then A = 61h 
See appendix F. 
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XBIOS 


25 




Put Scan Character 


Entry: 




C 


= 19H 






D 


= Shift Mask 

OOOB : no shift keys 

OOIB : shift 

OlOB : control 

OllB : control shift 

lOOB : graph shift 

lOlB : graph shift shift 






E 


= Scan Code 
- 7fh 






A 


= Code to be assigned 


XBIOS 


26 




Read Scan Code Table 



Description: 

Read scan code table from system track to memory, 

Entry: C = lAH 

Return: A = - operation successful 

A = 1 - operation unsuccessful 



XBIOS 27 



Write Scan Code Table 



Description: 

Write the current scan code table from memory to 
system track. 

Entry: C = IBH 

Return: A = - operation successful 

A <> - operation unsuccessful 



XBIOS 28 



Set BIOS To Return Scan Code or 



Converted Character 

Entry: C = ICH 

A = - Return Converted Scan Code 
A <> - Return Scan Code 
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XBIOS calls 29 - 45 deal with function key tables. Refer 
to Appendix G for a listing of Function Keys. 

XBIOS 29 Set Function Key Enable/Disable Mode 

Entry; C = IDH 

A = Enable Function Keys 
<> Disable Function Keys 

Description: Enables/Disables function key interpretation. 
Warmboot always enables function keys. 



XBIOS 30 Select Function Key Table 

Entry: C = lEH 

A = Selection Code 

- HASCI Table 

1 - TVI-920 Table 

2 - Custom Table 

Return: A = - operation successful 

A <> - operation unsuccessful 



XBIOS 31 Save Current Function Key Table Pointer 

Entry: C = IFH 

XBIOS 32 Restore Function Key Table Pointer 

Entry: C = 20H 

XBIOS 33 Get Selected Function Key Table 

Entry: C = 21H 

DE = Address of IK buffer to hold CFK table 

Return: Selected Function Key Table moved to buffer 

XBIOS 34 Put Selected Function Key Table 

Entry: C = 22H 

DE = Address of IK buffer containing a user 
defined PFK table 

Return: User defined PFK copied over Selected CFK. 
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XBIOS 35 Save Selected Function Key Table 

Entry: C = 23H 

Return; Contents of Selected Function Key Table copied to 
save area 

XBIOS 36 Restore Selected Function Key Table 

Entry: C = 24H 

Return: Contents of PFK save area copied over Selected 
Function Keys (only if a XBIOS 35 function 
previously performed) 

XBIOS 37 Get Function Key 



Entry: C = 25H 

DE = Address of 25 byte buffer 
A = Function Key # (0 - 22H) 

Return: Selected function key string moved to buffer 

XBIOS 38 Put Function Key 



Entry: 



Return: 



XBIOS 39 



C = 26H 

DE = Address of 25 byte buffer containing function key 

definition 
A = Function Key # (0 - 22H) 

Funtion key string in buffer moved to Selected 
Function Key Table 

Disable System Key 



Entry: 



C = 27H 

A = System Key Number 

key no. key label 



bold 
italic 
size 
style 
control stop 



function 

toggle bold fonts 

toggle italic fonts 

reserved 

toggle style fonts 

system pause 



control grph/shift stop cold boot 

control help status/help display 

control print screen dump 



Return: Selected System Key is disabled 
This Information is Proprietary to Epson America, Inc. 
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XBIOS 40 Enable System Key 

Entry: C = 28H 

A = System Key Number 

key numbers and definition same as XBIOS 39 

Return: Selected System Key is enabled 

XBIOS 41 Read Custom Function Key Table 

Description: 

Read custom function key table from system track 
to memory. 

Entry: C = 29H 

Return: A = - operation successful 

A <> - operation unsuccessful 

XBIOS 42 Write Custom Function Key Tables 

Entry: C = 2AH 

Return: A = - operation successful 

A <> - operation unsuccessful 

XBIOS 43 Enable Keyboard Reset at Warm Boot 



Entry: C = 2BH 
Description: 



Operation causes XBIOS functions 23, 36 & 32 
to be performed in that order at the next 
warm boot or XBIOS 44 request. Process 
resets the XBIOS 43 request. XBIOS 45 
disables request made by XBIOS 43. 



XBIOS 44 
Entry: 



Perform Warm Boot Reset 

C = 2CH 



Description: 



XBIOS 45 



Performs the warm boot processes normally 
invoked by XBIOS 43. This function should.be 
used by applications which trap the warm boot 
vector as a restart mechanism. 

Disarm Keyboard Reset 



Entry: C = 2DH 

Description: Disarms reset function armed by XBIOS 43 call. 
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XBIOS 46 



Request Memory Bank 



Entry: C = 2EH 

A = Bank # to request. 

Return: A = - operation successful 

A = 1 - illegal bank # requested 

2 - RAM disk is enabled and contains data 

Code can use XBIOS 51 to report condition 
to user. 



XBIOS 47 



Release Memory Bank 



Entry: C = 2FH 

A = Bank # to release 



XBIOS 48 



Move Block to another Bank 



Entry: C = 30H 

DE = Parameter Buffer Address 



Buffer Contents: 



byte - Source Bank (0 - 3) 
byte 1 - Destination Bank (1-3) 
bytes 2,3 - Source Address (Intel format) 
bytes 4,5 - Destination Address (Intel format) 
byte 6,7 - Byte Count (Intel format) 



Return: A = if successful 

A = <> if not successful 



XBIOS 49 



Call Code in another Bank 



Entry: 



C = 31H 

DE = Destination Address 

A = Destination Bank (1 



3) 



Return; 



The selected bank is enabled and program control 
is transferred to selected address. If an 
illegal bank request is made, an error message is 
displayed on the status line and a warm boot is 
performed. Calls can be nested 10 levels deep. 
Parameters can be passed on the stack. 



This Information is Proprietary to Epson America, Inc. 
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XBIOS 50 



Entry; 



Return; 



Jump to Code in another Bank 



C = 32H 

DE = Destination Address 

A = Destination Bank (1 



3) 



The selected bank is enabled and program control 
is transferred to selected address. If an 
illegal bank request is made, an error message is 
displayed on the status line and a warm boot is 
performed. 



XBIOS 51 



Display RAM Disk Overwrite Message 



Entry: C = 33H 
Description: 



Displays the RAM Disk Overwrite Message. 
Allows the operator to abort the process or 
continue. Upon continuing, RAM disk is 
cleared and previous Bank requested competed. 



XBIOS 52 Request Bank Error Overwrite 

Entry: C = 34H 

A = - Requested Bank is enabled. 
<>0 - Requested bank is enabled, 
enabled. User beware. 



Ramdisk is disabled, 
Ramdisk is left 



XBIOS 53 



RESERVED 



Entry: C = 35H 

Description: Reserved for future expansion. No operation, 



XBIOS 5^ 


\ 


PSET - Pixel Set/Reset 


Entry: 


C 


= 36H 




DE 


= X coordinate (0-639) 




HL 


= Y coordinate (0-399) 




A 


= Operation 

1 - Replace 

2 - Overstrike 

3 - Complement 

4 - Erase 



This Information is Proprietary to Epson America, Inc, 
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XBIOS 55 



Set Viewport 



Entry: C = 37H 

A = screen width (80 or less sets the width to a 

default of 80 chars. Max = 639) 
B = viewport number [0.,3] 
H = viewport type [0..2] 

= Character mode 

1 = Bit-map (non-graphic) 

2 = Graphic 

L = clear/no-clear flag [0..1] 

= No clear 

1 = Clear 



Description: Sets current Video View Port 



vid ram 
address 



viewport type 
CHAR BITMAP GRAPHIC 





2K 
4K 
6K 
8K 
16K 

32K 

48K 








1 




2 


3 13 


3 


OVERWRITE ALL 

CHARACTER WINDOWS 

1 


/////// 


1 1 

1 i 

1 1 
1 1 


i 1 

! 1 1 1 
1 1 




1 

2 1 2 
1 
1 



Viewport video ram mappings 
This Information is Proprietary to Epson America, Inc. 
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Description: 



This entry point is used to invoke the various 
GDP's supported by the BIOS. GPD's detailed 
in Appendix E. 



Entry: 


C 


= 38H 






B 


= Requested GDP 






- 


Write Mode 






1 - 


Set Pixel 






2 - 


Read Position 






3 - 


Line 






4 - 


Arc 






5 - 


Pie Slice 






6 - 


Circle 






7 - 


Rectangle 






8 - 


Polyline 






9 - 


Polygon 






10 - 


Block 






11 - 


Text 






12 - 


Set Color 






13 - 


Set Line Pattern 






14 - 


Set Fill Pattern 






15 - 


Hide Screen 






16 - 


Display Screen 






17 - 


Fill Screen 


XBIOS 57 




Di] 


rect Cursor Addressing 


Entry: 


C 


= 39H 






D 


= Row 


(0-23) 




E 


= Column (0-79) 


Description: 


PO! 


sitions cursor to requested 


BIOS 58 




Direct String Display Function 



Entry: C = 3AH 

B = Direction to display character: 

1 - Horizontal (Right) 

2 - Vertical (Down) 

D = Number of characters to display. 
E = Character to display. 



XBIOS 59 



RESERVED 



Entry: C = 3BH 

Description: Reserved for future expansion. No operation. 



)0 
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XBIQS 60 



Entry: 



00 
01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 



Set User Interrupt Vector 

C = 3CH 

A = Interrupt Number to be set 

B = Bank Where User Interrupt Service Routine Resides 

DE = User Interrupt Service Routine Address 

Power Down Detect 

Software Timer #1 

External Interrupt INTFl 

External Interrupt INTF2 

Protected (Keyboard/Serial Port) 

CRT/Light Pen Interrupt 

Floppy Controller Interupt 

Protected (Slave Cascade) 

Printer 

External Interrupt #1 

Protected (Calendar Clock) 

External Interrupt #2 

External Interrupt #3 

Protected (Software Timer #2) 

External Interrupt #4 

External Interrupt #5 

Keyboard (Interrupt 4 Decoded) 

Serial Port (Interrupt 4 Decoded) 



XBIOS 61 



Clear User Interrupt Vector 



Entry: C = SDH 

A = Interrupt Number 

This routine restores the interrupt to the system default 
condition. 



XBIOS 62 



Get Interrupt Mask 



Entry: C = 3EH 

On Return: 

DE = Interrrupt Mask 

This routine returns the 8259 interrupt mask. 
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XBIOS 63 Enable Interrupt 

Entry; C = 3FH 

DE = Interrupt Mask 

This routine enables the interrupts that correspond to the 
bits in DE that are set to 1 where the mask in register E 
affects the master 8259 and the mask in register D affects 
the slave 8259. 



XBIQS 64 Disable Interrupt 

Entry; C = 40H 

DE = Interrupt Mask 

This routine disables the interrupts that correspond to the 
bits in DE that are set to 1. 



XBIOS 65,66,67 — Not Available 

Description: The interrupt handler has been modified in 
B2.25. XBIOS 65, 66 and 67 are unsupported. 
A message is displayed indicating the running 
program is not supported under B2.25 and then 
warm boots the system. 

Entry; C = 41H,42H,43H 
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XBIOS 70 Clear field attributes in Character Driver 

Entry: C = 46H 

XBIOS 71 Clear field attributes in Bitmap Driver 

Entry: C = 47H 

XBIOS 72 Set Cursor Shape 

Entry: C = 48H 

HL = Address of array containing cursor shape 

XBIOS 73 Load CCP into TPA memory 

Entry: C = 49H 

XBIOS 74 Move boot string into CCP 

Entry: C = 4 AH 

HL = Address of ASCI I Z string. 

Command is invoked at each warraboot. 

XBIOS 75-90 Not Assigned 

XBIOS 91 Attach Internal Communications Driver 

Entry: C = 5BH 

XBIOS 92 Detach Internal Communications Driver 

Entry: C = 5CH 

XBIOS 93-127 Not Assigned 
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APPENDIX C. Graphics Drawing Primatives 





Primitive 


Parameter Block 






Comments 


Number Name 


Definition 











Write Mode 


Mode Byte 


HL 




= Replace 

1 = Complement (XOR) 

2 = Erase 

3 = Overstrike (OR) 


1 


Set Pixel 


X Coord 


HL 




0..639 






Y Coord 


DE 




0..399 


2 


Read Position 


no parms 






Returns: 

X Coord. : HL 
Y Coord. : DE 


3 


Line 


Starting X 
Starting Y 
Ending X 
Ending Y 


HL 
DE 
IX 
lY 






4 


Arc 


Center X 
Center Y 
Radius 


word 
word 
word 










Starting Angle 


word 


(0 


..359) 






Ending Angle 


word 


(0 


..359) 


5 


Pie Slice 


Fill Mode 
Center X 
Center Y 
Radius 


A 
word 
word 
word 




See note # 3 






Starting Angle 


word 


(0 


..359) 






Ending Angle 


word 


(0 


..359) 


6 


Circle 


Fill Mode 
Center X 
Center Y 
Radius 


A 
HL 
DE 
IX 




See note # 3 


7 


Rectangle 


Fill Mode 
Bottom Left X 
Bottom Left Y 
Upper Right X 
Upper Right Y 


A 

HL 

' DE 

IX 

lY 




See Note # 3 
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Primitive 
Number Name 



Parameter Block 
Definition 



Comments 



8 Polyline 



Number of lines : DE 
Coord Array Addr: HL 



See Note # 1 



9 Polygon 



Fill Mode : A 
# of vertices : DE 
Coord Array Addr: HL 



See note # 3 
See Note # 1 



10 Block 



Mode byte : word 

X dimension : word 

Y dimension : word 
X position : word 

Y position : word 
Buffer address : word 



= Write , 1 = Read 



11 Text 



12 Set Color 



13 

14 

15 
16 
17 



Set Line 
Pattern 

Set Fill 
Pattern 



Text attribute : A 

X position : HL 

Y position : DE 

Text length : IX 

Text buf . addr. : lY 

Color number : HL 



Pattern : HL 



Pattern Address : HL 



none 



See Note # 4 



Hide Screen 

Display Screen none 

Fill Screen Pattern 



HL 



Ordinal value (0. .7) 
for current color 

16 bit pattern 



Sets the current fill 
pattern 

Blanks current screen 

Displays current screen 

Pattern = 0, clear screen 
= 1 , set to 1 
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Notes: 

#1 The Coord, Array Address field used by both POLYLINE and 
POLYGON is actually a pointer to a variable length array 
(upto 255 maximum coordinate entries ) with the following 
structure: 



for POLYLINE: 

Starting X : word 

Starting Y : word 

Ending X(l) : word 

Ending Y(l)^ : word 

Ending X(N) : word 

Ending Y(N) : word 

N = number of vertices 



coordinate of first line 



for POLYGON: 



Vertex #1, X coord.: word 
Vertex #1, Y coord.: word 



Vertex #N, X coord. 
Vertex #N, Y coord. 



word 
word 



N = number of vertices 

For a polygon call we assume that the figure is closed and 
that the line from vertex N to vertex #1 will be drawn. 



#2 Primitive Graphic Routine Calling Convention: 

For primitives number: 0,1,2,3,6,7,8,9,11,12,13,14,15,16,17 

parameters are passed in the indicated register pairs 
in the parameter block definition column of the above 
table. 

For primitives number: 4,5,10 ( Arc, Pie Slice, Block ) 

HL - address of the parameter block; the structure of 
this block is dependent upon the particular 
graphic routine called. 

All routines are accessed by passing the graphic routine 
number in register B ; register C has the XBIOS call value 
of 56. 



** 12/10/84 ** CP/M-80 R2.2 ERS - Release B2.26 Page C-4 



#3 Fill Mode byte 

The rectangle, circle, pie slice, and polygon primitves use 
a mode byte which indicates the following fill/boundary 
modes; 

Bit Position: - = draw the boundary of the figure 

1 = DO NOT draw the boundary 

1 - = fill the figure with the current 
fill pattern 
1 = DO NOT fill the figure 

2., 7 - reserved for future use 

#4 Text Attributes 

Attributes for the text primitive are specified by bit 
positions in the attribute byte passed in register A. 
Following are the bit positions and their corresponding 
attributes. Setting a bit to 1 turns the atribute ON. 



Bit posi 


tion 


Att 


ribute 


7 






Reverse Video 


6 






Underline 


5 






(Unused) 


4 






Super-script 


3 






Sub-script 


2 






Style Font 


1 






Italics Font 









Bold Version of a Font 



(i.e. a value of 83h will allow the text to be written from 
the BOLD, ITALICS Font in REVERSE Video) 
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APPENDIX D, 
Entry Offset Bytes 
EYEBALL 00 20 
RELEASE 21 1 
REVLVL 22 3 
ERREC 25 1 

ERRDIAG 26 1 

CLOCK 27 1 

CRTWRAP 28 1 



CBLINK 29 



KEYBOARD 30 



TYPAMAT 31 1 



lOBYTE 32 1 



System Data Page 
Description 
Visual locator 
Bios Release Level - 'B' 
Bios Revision Level - '225' 

Disk Error Recovery 

- disabled 

1 - enabled 

Disk Diagnostics 

- disabled 

1 - enabled 

Date - Time Display 

- disabled 

1 - enabled 

Auto Line Wrap 

- disabled 

1 - enabled 

Cursor Blink 

- disabled 

1 - enabled 

Connected Keyboard 

1 - HASCI 1 

2 - HASCI 2 

3 - QX-16 

Typamatic ' 

- disabled 

1 - enabled 

CP/M lOBYTE 
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Entry Offset Bytes 
SIOIBD 33 1 



SIOIPRO 34 



SIOIPAR 35 



SIOISTP 36 



SIOIDTA 37 



AUTO 



DISPM 



SERM 



38 



39 



40 



Description 

7201 Baud Rate 
- none 
1-50 
2-75 

3 - 110 

4 - 134 

5 - 150 

6 - 300 
7-600 

8 - 1200 

9 - 1800 

10 - 2400 

11 - 3600 

12 - 4800 

13 - 7200 

14 - 9600 

7201 Protocol 

- none 

1 - ETX/ACK 

2 - RTS/CTS 

3 - XON/XOFF 

7201 Parity Bits 

- none 

1 - odd 

2 - even 

7201 Stop Bits 
0-1 
1 - 1.5 
2-2 

7201 Data Bits 
0-5 
1-6 
2-7 
3-8 

Turnkey Cold Boot 

- disabled 

1 - enabled 

Display Unit Bit 7 Masking 

- disabled 

1 - enabled 

Serial Port Bit 7 Masking 

- disabled 

1 - enabled 



KQ 
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SHFTLOK 41 



FUNCTBL 42 



RAMDISK 43 1 



PRINTER 44 1 



SHIFT LOCK Interpretation 

- Caps Lock 

1 - Shift Lock 

Function Table Selector 

- H ASCI 

1 - TVI-920 

2 - Custom 



RAM 


Disk Active 




- 


disabled 




1 - 


enabled 




Parallel Port Pr 


'i 


- 


none 




1 - 


undefined 




2 - 


Centronics 




3 - 


FX-80 




4 - 


FX-lOO 




5 - 


RX-80 




6 - 


RX-lOO 




7 - 


MX-80 




8 - 


MX-lOO 




9 - 


LQ-1500 




10 


- Comrex CR- 


■1 


12 


- Comrex CR- 


■2 


13 


- Comrex CR- 


■3 



DSKFMT 45 1 



VIDTYP 



46 



PARMASK 47 



SERINT 



SSHEET 



48 



49 



Right Diskette Format 

- QXIO - 380k 

1 - QXIO - 300k 

2 - MFCP/M 

3 - IBM 1 

4 - IBM 2 

CRT Driver enabled 

- Character 

1 - Bit Image 

Parallel Port 7 bit masking 

- disabled 

1 - enabled 

Serial Port Interrupt Handler Enabled 

- Polled Driver 

1 - Interrupt Driver 

Single Sheet Mode Support 

- disabled 

1 - enabled 



60 
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Entry Offset Bytes 
SYSDRV 50 1 

SDPLOT 51 1 

SETSD 52 1 
INTLFONT 53 1 

SCRNSAVER 54 1 



QXVER 



fill 



55 



56 



GABYl 


57 




GABYl 


58 




GABY2 


59 




GABY4 


60 




GABY5 


61 




GABY6 


62 




GABY7 


63 





DRVASG 



64 16 



CURASG 80 16 

AUTOLEN 96 1 

AUTOBOOT 97 24 

VALID 127 1 



Description 

System Boot Drive 
- Left Floppy 
<>0 - Hard Disk 

Screen Dump to Plotter 
- Not Installed. 
<>0 - Installed, (Ramdisk disabled). 

Screen Dump Attribute Byte 

International Fonts Loaded 
- Not Installed 
<>0 - Installed. 

Screen Saver 

- disabled 

1 - enabled 

QX-machine type 

- QX-10 

1 - QX-16 

not used 

Program disk assignment 

Data disk assignment 

Modem type 

Phone type 

GABY return drive 

GABY expert level 

GABY system warmboot string flag 

Disk Drive Assignments at Cold Boot 

1 - Left Diskette 

2 - Right Diskette 

3 - RAM Disk 

4 - Logical Hard Disk 1 

5 - Logical Hard Disk 2 

Current Drive Assigments 

Cold Boot Turnkey String Length 
0-24 

Cold Boot Turnkey String 

System Data Page Initialized Byte 
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APPENDIX E. Console Control and Escape Sequences 



E.l TVI-920 CONTROL AND ESCAPE SEQUENCES 



FUNCTION 


CTRL/ESC 


HEX 


CHR 


GRPH 




SEQ 


CODE 


DRV 


DRV 


Bell 


CTRL G 


07 


X 


X 


Carriage Return 


CTRL M 


OD 


X 


X 


Cursor Left 


CTRL H 


08 


X 


X 


Cursor Right 


CTRL L 


OC 


X 


X 


Cursor Down 


CTRL J 


OA 


X 


X 


Cursor Up 


CTRL K 


OB 


X 


X 


Cursor Home 


CTRL ^ 


IE 


X 


X 


Address Cursor 


* ESC = re 


IB, 3D re 


X 


X 


Read Cursor 


ESC ? 


1B,3F 


X 


X 


Linefeed 


CTRL J 


OA 


X 


X 


Tab 


CTRL I 


09 


X 


X 


Backtab 


ESC I 


IB, 49 


X 


X 


Clear Screen 


CTRL Z 


lA 


X 


X 


Clear All To Space 


ESC + 


1B,2B 


X 


X 


Character Insert 


ESC Q 


IB, 51 


X 


X 


Character Delete 


ESC W 


IB, 57 


X 


X 


Line Insert 


ESC E 


IB, 45 


X 


X 


Line Delete 


ESC R 


IB, 52 


X 


X 


Reverse Video 


ESC j 


1B,6A 


X 


X 


End of Reverse Video 


ESC k 


1B,6B 


X 


X 


Start Underline 


ESC 1 


1B,6C 


** 


X 


End Underline 


ESC in 


1B,6D 


** 


X 


Start Blink Field 


ESC '^ 


1B,5E 


X 


** 


Start Blank Field 


ESC 


IB, 20 


X 


** 


End Blink/Blank 


ESC q 


IB, 71 


X 


** 


Erase EOL with Spaces 


ESC T 


IB, 54 


X 


X 


Erase EOP with Spaces 


ESC Y 


IB, 59 


X 


X 


Lock Keyboard 


ESC # 


IB, 23 


X 


X 


Unlock Keyboard 


ESC " 


IB, 22 


X 


X 


High Intensity Off 


ESC ( 


IB, 28 


X 


X 


High Intensity On 


ESC ) 


IB, 29 


X 


X 


New Line 


CTRL _ 


IF 






Set Block Mode 


ESC B 


IB, 42 






Set Conversation Mode 


ESC C 


IB, 43 






Protect Mode On 


ESC & 


IB, 26 






Protect Mode Off 


ESC ' 


IB, 27 






Set Column TAB 


ESC 1 


IB, 31 






Clear TAB 


ESC 2 


IB, 32 






Clear All TAB 


ESC 3 


IB, 33 






TAB 


ESC i 


IB, 69 
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FUNCTION 



Send Line Unprotected 

to Cursor Position 
Send Page Unprotected 

to Cursor Position 
Send Whole Page 

Unprotected 
Send Line All to Cursor 

Position 
Send Page All to Cursor 

Position 
Send Whole Page 
Clear All to NULL 
Clear Unprotected to NULL 
Line Erase to NULL 
Page Erase to NULL 
Toggle Page 
Load Cursor 

(PAGE, ROW, COLUMN) 
Read Cursor 

(PAGE, ROW, COLUMN) 
Auto Flip On 
Auto Flip Off 
Extension Port On 
Extension Port Off 

Page Print Mode On 
Print Page 



CTRL/ESC 


HEX 


CHR 


GRPH 


SEQ 


CODE 


DRV 


DRV 


ESC 4 


IB, 34 






ESC 5 


IB, 35 






ESC S 


IB, 53 







ESC 6 



ESC - 



IB, 36 



ESC 7 


IB, 37 


ESC s 


IB, 73 


ESC * 


1B,2A 


ESC : 


1B,3A 


ESC t 


IB, 74 


ESC y 


IB, 79 


ESC K 


1B,4B 



IB, 2D 



ESC / 


1B,2F 


ESC V 


IB, 76 


ESC w 


IB, 77 


ESC @ 


IB, 40 


ESC A 


IB, 41 


ESC P 


IB, 50 



Function implemented. 



NOTE: Direct cursor positioning 
following escape sequence: 



is accomplished by the 



ESC = ROW+20H C0I+2OH where Row =1-24, Col = 1-80 

** NOTE: These attributes will have no effect but will result 
in a space (blank) being written in their place. This will 
insure proper cursor positioning relative to the TVI-920. 
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E.2 QX-10 CONTROL AND ESCAPE SEQUENCES 



FUNCTION 



Set Font 

Load Font-character 

Sub-script 

Super-script 

Normal-script 

LED On 

LED Off 

Feregreund-Geief 

Baekgrewnd-Geier 

Set Reverse Video 
Reset Reverse Video 
Set Underline 
Reset Underline 
Cursor on 
Cursor off 



X - Function implemented. 



CTRL/ESC 


HEX 


CHR 


GRPH 


SEQ 


CODE 


DRV 


DRV 


ESC X 1 n 


lB,58,31,n 




X 


ESC X 2 n 


IB, 58, 32, n 




X 


ESC X 3 


IB, 58,33 




X 


ESC X 4 


IB, 58, 34 




X 


ESC X 5 


IB, 58, 35 




X 


ESC X 6 n 


IB, 58, 36, n 


X 


X 


ESC X 7 n 


IB, 58, 37, n 


X 


X 


-Ese-x-8 — 


-iB-§8T38Tn- 




— X 


-Ese-x-9— 


-lB7d8-39-n— 




— X 


ESC X A 


IB, 58, 41 




X 


ESC X B 


IB, 58,42 




X 


ESC X C 


IB, 58,43 




X 


ESC X D 


IB, 58, 44 




X 


ESC X E 


IB, 58, 45 


X 


X 


ESC X F 


IB, 58, 46 


X 


X 
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E.3 CONTROL AND ESCAPE SEQUENCE DESCRIPTIONS 



Set Font - select a font from the set of available fonts 

Escape Sequence : ESC XI N 

Hex Codes : IB 58 31 00.. 06 

N is the number of the selected font from the following set: 



FONT N 



Standard Font OOh 

BOLD Standard Font Olh 

Italics Font 02h 

BOLD Italics Font 03h 

User defined Style Font 04h 

BOLD Style 05h 



Load Font-character - load an 8 X 16 pattern for a selected 

character in the user defined style 
font 

Escape Sequence : ESC X 2 ordinal value P1...P16 
Hex Sequence : IB 58 32 00.. 127 



Ordinal Value is the ASCII code for the character that is 
being defined. 



PI to P16 are 16 pattern bytes of the character. 



PLEASE SEE GRAPHICS CHARACTER DEFINITION APPENDIX FOR 
FURTHER DETAILS. 
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Sub-Script - write all subsequent characters in subscript 
mode 

Escape sequence : ESC X 3 
HEX Code : IB 58 33 



All subsequent characters are selected from a special half- 
height character font until the normal-script escape 
sequence is issued. 



Super-Script - write all subsequent characters in super- 
script mode 

Escape sequence : ESC X 4 
HEX Code : IB 58 34 

All subsequent characters are selected from a special half- 
height character font until the normal-script escape 
sequence is issued. 



Normal-Script - change to the currently selected font 

Escape sequence : ESC X 5 
HEX Code : IB 58 35 

If in Sub- or Super-script mode, will revert to normal mode. 
Subsequent characters are written from the currently 
selected font. 



LED ON - turn the selected LED on 

Escape sequence : ESC X 6 N 

HEX Code : IB 58 36 01.. 08 

N is the number of the selected LED; numbered from 1 to 



LED OFF - turn the selected LED off 

Escape sequence ; ESC X 7 N 

HEX code : IB 58 37 01.. 08 

N is the same as for LED ON above 
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Set Reverse Video - all subsequent characters are written in 
reverse video mode 

Escape sequence : ESC X A 
HEX Code : IB 58 41 

This is the mode attribute version of reverse video. All 
subsequent characters are written in reverse video until a 
reset reverse video escape sequence is issued. 



Reset Reverse Video - cancels reverse video mode (if active 

Escape sequence : ESC X B 
HEX Code : IB 58 42 

All subsequent characters are written in standard mode 



Set Underline - all subsequent characters are underlined 

Escape sequence : ESC X C 
HEX Code : IB 58 43 

All subsequent written characters are underlined until a 
RESET Underline escape sequence is sent. 



Reset Underline - cancels underline mode (if active) 

Escape sequence : ESC X D 
HEX Code : IB 58 44 

All subsequent characters are written in standard mode. 



Cursor On - allows the cursor to be displayed 

Escape sequence : ESC X E 
HEX Code : IB 58 45 

Cursor is displayed 



Cursor Off - cursor is not displayed 

Escape sequence : ESC X F 
HEX Code : IB 58 46 

Cursor is not displayed. 
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APPENDIX F. HASCI-1 Keyboard Mapping 



KEY 


SCAN 
CODE 


AL 


AU 


CL 


cu 


GL 


GU 




STOP 


73 


FOl 


00 


SOS 


00 


00 


00 




HELP 


72 


F02 


F19 


S06 


00 


00 


00 




COPYDISK 


71 


F03 


F20 


00 


00 


00 


00 




UNDO 


01 


F04 


F21 


00 


00 


00 


00 




STORE 


03 


F05 


F22 


00 


00 


00 


00 




RETRIEVE 


04 


F06 


F23 


00 


00 


00 


00 




PRINT 


05 


F07, 


F24 


S07 


00 


00 


00 




INDEX 


06 


F08 


F25 


00 


00 


00 


00 




MAIL 


07 


F09 


F26 


00 


00 


00 


00 




EDIT 


09 


FIO 


F27 


00 


00 


00 


00 


N/A HASCI-1 


MENU 


08 


Fll 


F28 


00 


00 


00 


00 




CALC 


OA 


F12 


F29 


00 


00 


00 


00 




SCHED 


OB 


F13 


F30 


00 


00 


00 


00 




DRAW 


OC 


F14 


F31 


00 


00 


00 


00 




BOLD 


OE 


F15 


F32 


SOI 


00 


00 


00 




ITALIC 


OF 


F16 


F33 


S02 


00 


00 


00 




SIZE 


IF 


F17 


F34 


SOS 


00 


00 


00 




STYLE 


IE 


F18 


F35 


S04 


00 


00 


00 





MAR REL 


74 


IB 


IB 


IB 


IB 


00 


00 


^ 


75 


BB 


5E 


00 


IE 


AO 


AC 


! 1 


76 


31 


21 


11 


01 


Al 


AD 


@ 2 


61 


32 


40 


12 


00 


A2 


AE 


# 3 


62 


33 


23 


13 


03 


A3 


AF 


$ 4 


63 


34 


24 


14 


04 


A4 


A9 


% 5 


64 


35 


25 


15 


05 


A5 


AA 


6 


65 


36 


C4 


16 


00 


E6 


E4 


& 7 


66 


37 


26 


17 


07 


DD 


DA 


* 8 


67 


38 


2A 


18 


OA 


ED 


EA 


( 9 


68 


39 


28 


19 


08 


FD 


FA 


) 


69 


30 


29 


10 


09 


F6 


F4 


_ - 


6A 


2D 


5F 


OD 


IF 


60 


C6 


+ = 


6B 


3D 


2B 


ID 


OB 


7C 


C7 


\ 


6C 


5C 


BD 


ic 


00 


7E 


CO 


1X> 


6D 


08 


08 


08 


08 


00 


00 
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KEY 


SCAN 
CODE 


AL 


AU 


CL 


CU 


GL 


GU 


TAB 


77 


09 


09 


09 


09 


00 


00 


Q q 


51 


71 


51 


11 


11 


A6 


B8 


W w 


52 


77 


57 


17 


17 


A7 


A8 


E e 


53 


65 


45 


05 


05 


BO 


B9 


R r 


54 


72 


52 


12 


12 


Bl 


BA 


T t 


55 


74 


54 


14 


14 


E2 


EO 


Y y 


56 


79 


59 


19 


19 


F2 


FO 


U u 


57 


75 


55 


15 


15 


E9 


F9 


I i 


58 


69 


49 


09 


09 


DE 


DB 


o 


59 


6F 


4F 


OF 


OF 


EE 


EB 


P P 


5A 


70 


50 


10 


10 


FE 


FB 




5B 


BE 


BF 


00 


00 


D7 


D8 


[ < 


5C 


3C 


5B 


IC 


IB 


7B 


C2 


] > 


5D 


3E 


5D 


IE 


ID 


7D 


C3 


TAB REL 


41 


00 


00 


00 


00 


00 


00 


SHIFT LOCK 


42 


00 


00 


00 


00 


00 


00 


A a 


43 


61 


41 


01 


01 


cc 


CD 


S s 


44 


73 


53 


13 


03 


B2 


B3 


D d 


45 


64 


44 


04 


04 


BC 


B4 


F f 


46 


66 


46 


06 


06 


B7 


B6 


G g 


47 


67 


47 


07 


07 


E3 


El 


H h 


48 


68 


48 


08 


08 


F3 


Fl 


J 3 


49 


6A 


4A 


OA 


OA 


E8 


F8 


K k 


4A 


6B 


4B 


OB 


OB 


DF 


DC 


L 1 


4B 


6C 


4C 


OC 


OC 


EF 


EC 


• » 


4C 


3B 


3A 


IB 


lA 


FF 


FC 


ft } 


4D 


27 


22 


07 


02 


D7 


CI 


RETURN 


4E 


OD 


OD 


OD 


OD 


00 


00 


TAB SET 


78 


00 


00 


00 


00 


00 


00 


SHIFT 


86 87 


00 


00 


00 


00 


00 


00 


Z z 


33 


7A 


5A 


lA 


lA 


CE 


CF 


X X 


34 


78 


58 


18 


18 


AB 


B5 


C c 


35 


63 


43 


03 


03 


DO 


D4 


V V 


36 


76 


56 


16 


16 


Dl 


D5 


B b 


37 


62 


42 


02 


02 


D2 


C5 


N n 


38 


6E 


4E 


OE 


OE 


D3 


D6 


M m 


39 


6D 


4D 


OD 


OD 


E7 


E5 


J > 


3A 


2C 


2C 


OC 


OC 


C8 


CA 


, , 


3B 


2E 


2E 


OE 


OE 


C9 


CB 


? / 


4F 


2F 


3F 


OF 


OF 


F7 


F5 


SHIFT 1 


84 85 


00 


00 


00 


00 


00 


00 


CTRL 


8A 8B 


00 


00 


00 


00 


00 


GO 


SPACE BAR 


32 


20 


20 


20 


20 


20 


20 


GRPH SHIFT 


8C 8D 


00 


00 


00 


00 


00 


00 


CTRL 


8E 8F 


00 


00 


00 


00 


00 


00 



fi 
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KEY 


SCAN 
CODE 


AL 


AU 


CL 


CU 


GL 


GU 


<xi 


6E 


7F 


7F 


7F 


7F 


00 


00 


LINE 


6F 


OA 


OA 


OA 


OA 


00 


00 


INSERT 


5E 


00 


00 


00 


00 


00 


00 


WORD 


5F 


IE 


IE 


IE 


IE 


00 


00 


UP ARROW 


3C 


OB 


12 


OB 


12 


00 


00 


< — 


3D 


08 


01 


08 


01 


00 


00 


— > 


3E 


OC 


06 


OC 


06 


00 


00 



DOWN ARROW 3F 



OA 03 OA 03 00 00 



DEC 


.TAB 


2F 


00 


00 


00 


00 


00 


00 


Div: 


ISION 


2E 


2F 


2F 


2F 


2F 


00 


00 


X 




2D 


2A 


2A 


2A 


2A 


00 


00 


- 




IC 


2C 


2C 


2C 


2C 


00 


00 


7 




2B 


37 


37 


37 


37 


00 


00 


8 




2A 


38 


38 


38 


38 


00 


00 


9 




29 


39 


39 


39 


39 


00 


00 


+ 




2C 


2B 


2B 


2B 


2B 


00 


00 


4 




IB 


34 


34 


34 


34 


00 


00 


5 




lA 


35 


35 


35 


35 


00 


00 


6 




19 


36 


36 


36 


36 


00 


00 


= 




28 


3D 


3D 


3D 


3D 


00 


00 


1 




27 


31 


31 


31 


31 


00 


00 


2 




26 


32 


32 


32 


32 


00 


00 


3 




25 


33 


33 


33 


33 


00 


00 


ENTER 


15 


OD 


OD 


OD 


OD 


00 


00 







17 


30 


30 


30 


30 


00 


00 


• 




16 


2E 


2E 


2E 


2E 


00 


00 




LEGEND: 




AL 


- NO 


SHIFT 


KEYS 












AU 


- SHIFT 














CL 


- CONTROL 














CU 


- CONTROL 


SHIFT 












GL 


- GRAPH SHIFT 












GU 


- GRAPH SHIFT SHIFT 





+/■ 



ENTER = 
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APPENDIX G. Extended Keyboard Support 
G.l System Keys 



System Keys invoke a BIOS function to occur at the time the 
key is depressed. Initial System Key functions are: 

CTRL BOLD - Toggle Bold Font (Graphics Driver Only) 

CTRL ITLALIC - Toggle Italics Font (Graphics Driver Only 

CTRL SIZE - Size Key (reserved for future use) 

CTRL STYLE - Toggle Style Font (Graphics Driver Only) 

CTRL STOP - System Pause 

CTRL GRPH SHIFT STOP - Reset System (Cold Boot) 

CTRL HELP - System Status Display 

CRL PRINT - Screen Dump 

The user cannot add or change System Keys. The System Key 
definitions are set at System Generation time. An 
application program can disable (and re-enable) a System Key 
in order to allow the key to be redefined as a function key 
so that the application can process it (a wordprocessor may 
wish to provide font capabilities and would require the font 
keys). 

The VAR and OEM can redefine the System Keys described above 
as well as adding new System Keys, There is no upper limit. 
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E.2 Function Keys 

Functions Keys differ from the normal set of keys in that 
when depressed a Function Key will insert a string of 
characters (as opposed to one character) in the keyboard 
buffer. Any key on the keyboard may be assigned as a 
Function Key. Tables within the keyboard support code 
designate a unique scan code and shift keys combination 
(shift, control, graph shift) as a Function Key. Three 
tables for function key mappings are provided: 

HASCI - a QX-10 implementation which highlights QX-10 
features and keyboard layout. 

TVI920 - a TVI-920 implementation which provides 
function key definitions as defined by Televideo for 
programs requiring the TVI-920 mapping. 

CUSTOM - a general function key table which the user 
can modify through SETUP or an application program. 
These modifications can be temporary or can be made 
permanent. 

VAR's and OEM's have the ability to generate a baseline 
function key mappings that support their particular 
environment. 

The user cannot modify the tables which define the 
particular scan codes that identify the function keys. 
However, the user can modify the character strings produced 
by the function keys. 

As with System Keys, Function Keys can be enabled/disabled 
by an application program. Additionally, function keys can 
be protected such that modification by SETUP is disabled. 

Following is the TVI-920 function key table. 
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FUNCTION KEY SCAN CODE TABLE - TVI-920 

BYTE 1 - SCAN CODE 
BYTE 2 - ATTRIBUTES 

BITS 0-2 - SCAN MASK 
BYTES 3,4 - OFFSET INTO STRING TABLE 

; TELEVIDEO-920 FUNCTION KEYS TABLE 
UNSHIFTED FUNCTION KEYS 

@FK920: 



DB 


73H,00H 


DW 


* FKOFFSET 


DB 


72H,00H 


DW 


1 * FKOFFSET 


DB 


71H,00H 


DW 


2 * FKOFFSET 


DB 


OlHjOOH 


DW 


3 * FKOFFSET 


DB 


03H,00H 


DW 


4 * FKOFFSET 


DB 


04H,00H 


DW 


5 * FKOFFSET 


DB 


05H,00H 


DW 


6 * FKOFFSET 


DB 


06H,00H 


DW 


7 * FKOFFSET 


DB 


07H,00H 


DW 


8 * FKOFFSET 


DB 


09H,00H 


DW 


9 * FKOFFSET 


DB 


08H,00H 


DW 


10 * FKOFFSET 


DB 


OAHjOOH 


DW 


11 * FKOFFSET 


DB 


OBH , OOH 


DW 


12 * FKOFFSET 


DB 


OCH,OOH 


DW 


13 * FKOFFSET 


DB 


OEH,OOH 


DW 


14 * FKOFFSET 


DB 


OFH,OOH 


DW 


15 * FKOFFSET 


DB 


IFHjOOH 


DW 


16 * FKOFFSET 


DB 


lEH , OOH 


DW 


17 *FKOFFSET 



16 
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;UNSHIFTED FUNCTION KEYS 



DB 


72H,01H 


DW 


18 * FKOFFSET 


DB 


71H,01H 


DW 


19 * FKOFFSET 


DB 


01H,01H 


DW 


20 * FKOFFSET 


DB 


03H,01H 


DW 


21 * FKOFFSET 


DB 


04H,01H 


DW 


22 * FKOFFSET 


DB 


05H,01H 


DW 


23 * FKOFFSET 


DB 


06H,01H 


DW 


24 * FKOFFSET 


DB 


07H,01H 


DW 


25 ^ FKOFFSET 


DB 


09H,01H 


DW 


26 * FKOFFSET 


DB 


08H,01H 


DW 


27 * FKOFFSET 


DB 


0AH,01H 


DW 


28 * FKOFFSET 


DB 


OBHjOlH 


DW 


29 * FKOFFSET 


DB 


0CH,01H 


DW 


30 * FKOFFSET 


DB 


0EH,01H 


DW 


31 * FKOFFSET 


DB 


0FH,01H 


DW 


32 * FKOFFSET 


DB 


1FH,01H 


DW 


33 * FKOFFSET 


DB 


1EH,01H 


DW 


34 ^FKOFFSET 


FFSET EQU 


25 



; OFFSET MULTIPLIER 



This Information is Proprietary to Epson America, Inc. 



** 12/10/84 ** CP/M-80 R2.2 ERS - Release B2.26 



Page G-5 



PROGRAMMABLE FUNCTION KEY STRINGS 

BYTE 1 - ATTRIBUTES 

BIT 7 - ENABLED/DISABLED 

BIT 6 - PROTECTED 

BIT 5 - CARRIAGE RETURN DELIMITED 

BIT 0-4 - STRING LENGTH (MAX = 24) 
BYTES 2-25 - STRING 



DB 


BOH 


DS 


24 


DB 


25H, 'SETUP 


DB 


28H,'C0PYDISK 


DB 


22H,01H,40H 


DS 


22 


DB 


22H,01H,41H 


DS 


22 


DB 


22H,01H,42H 


DS 


22 


DB 


22H,01H,43H 


DS 


22 


DB 


22H,01H,44H 


DS 


22 


DB 


22H,01H,45H 


DS 


22 


DB 


22H,01H,46H 


DS 


22 


DB 


22H,01H,47H 


DS 


22 


DB 


22H,0lH,48H 


DS 


22 


DB 


22H,01H,49H 


DS 


22 


DB 


22H,01H,4AH 


DS 


22 


DB 


BOH 


DS 


24 


DB 


80H 


DS 


24 


DB 


80H 


DS 


24 


DB 


80H 


DS 


24 



STOP 

HELP 

COPYDISK 

UNDO 

STORE 

RETRIEVE 

PRINT 

INDEX 

MAIL 

MENU 

EDIT 

CALC 

SCHED 

DRAW 

BOLD 

ITALIC 

SIZE 

STYLE 
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; SHIFTED FUNCTION KEYS 



DB 


BOH 


DS 


24 


DB 


80H 


DS 


24 


DB 


22H,01H,60H 


DS 


22 


DB 


22H,01H,61H 


DS 


22 


DB 


22H,01H,62H 


DS 


22 


DB 


22H,01H,63H 


DS 


22 


DB 


22H,01H,64H 


DS 


22 


DB 


22H,01H,65H 


DS 


22 


DB 


22H,01H,66H 


DS 


22 


DB 


22H,01H,67H 


DS 


22 


DB 


22H,01H,68H 


DS 


22 


DB 


22H,01H,69H 


DS 


22 


DB 


22H,01H,6AH 


DS 


22 


DB 


80H 


DS 


24 


DB 


80H 


DS 


24 


DB 


80H 


DS 


24 


DB 


80H 


DS 


24 



DS 



HELP 

COPYDISK 

UNDO 

STORE 

RETREIVE 

PRINT 

INDEX 

MAIL 

MENU 

EDIT 

CALC 

SCHED 

DRAW 

BOLD 

ITALIC 

SIZE 

STYLE 

;TAKE UP SPACE FOR IK BOUNDARY ON DISK I/O 
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APPENDIX H. Optional Diskette Formats 



FORMAT DENSITY SIDES/ TRKS/ SECTORS/ BYTES/ SYSTEM 
DISK SIDE TRACK SECTOR TRACKS 



QX-10 


DOUBLE 


2 


40 


10 


512 


2 


380K 














QX-10 


DOUBLE 


2 


40 


16 


256 


2 


300K 














MFCPM 


DOUBLE 


2 


40 


16 


256 


4 


I HMD 


DOUBLE 


2 


40 


9 


512 


2 


IBMS 


DOUBLE 


1 


40 


8 


512 


2 



The IBM formats above refer to CP/M-86 implementations. 
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APPENDIX I, Error and Status Messages 



There is one printer error message described in Appendix 
I.l, and four disk error messages described in Appendix 1.2. 
All situations have in common the fact that the User is 
prompted for certain decisions; namely, for the printer the 
User is prompted for a decision to: Correct the printer 
fault or "(A)bort/(I )gnore output until warmboot" and for 
the disk the User is prompted to select a decision from four 
alternatives "(R)etry/(A)bort/{C)ontinue/(I Ignore" . 



The effect of each decision is as follows: 

{R)etry - Attempt I/O operation again. 

(A)bort - Cancel current operation and program. 
Invoke a system warmstart. 

(C)ontinue - Continue operation and return error 
code to BDOS. 

(I)gnore - Alter disk I/O return code to indicate 
a sucessful I/O operation and return 
to BDOS. 

(I)gnore output until warmboot - Ignore any printer 
output request until next system warmstart. 



I.l PRINTER ERROR AND STATUS MESSAGES 
Following is the printer error and status message: 

Printer Not Ready Correct fault or (A)bort/(I )gnore output until warmboot 

Cause: The printer is either: 

disconnected 

connected but powered off 

connected, powered on but offline 

connected, powered on, online but out of paper 

This Information is Proprietary to Epson America, Inc. 
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1.2 FLOPPY DISK ERROR AND STATUS MESSAGES 

The following are the floppy disk error and status messages: 

DRIVE X - SELECT ERROR: (R)etry/(A)bort 
Cause: A non-existent drive has been selected, 

DRIVE X - SEEK ERROR: (R)etry/(A)bort/(C)ontinue/{I )gnore 

Possible Causes: 

- a bad diskette 

- corrupted data 

- erroneous program instruction 

DRIVE X - RD/WR ERROR: (R)etry/(A)bort/(C)ontinue/(I )gnore 

Possible Causes: 

- a bad diskette 

- corrupted data 

- the diskette has a write protect tab on it 

DRIVE X - NOT READY: (R)etry/(A)bort/(C)ontinue/( I )gnore 

Possible Causes: 

- the 'PUSH' button on the disk drive has not been depressed 

- a diskette has not been inserted in the selected drive 

- the selected drive does not exist 



This Information is Proprietary to Epson America, Inc. 
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Appendix J, Fonts Tables 

The fonts table for the standard font is attached as 
follows. 
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